home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / ifl / iflPCD.z / iflPCD
Text File  |  1998-10-20  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. iiiiffffllllPPPPCCCCDDDD((((3333))))         IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll          iiiiffffllllPPPPCCCCDDDD((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiiffffllllPPPPCCCCDDDD - Kodak Photo CD Image Pac file format
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      This IFL format is used to access image files on a Kodak Photo CD.  Each
  13.      image on the CD is stored in a Kodak Photo CD Image Pac file.  On Pro
  14.      Photo CD's higher resolution image data is stored in the Image Pac
  15.      Extension area of the CD; this class automatically finds this data when
  16.      asked to access the 64Base size.  A file in this format consists of
  17.      representations of a single photographic image accessible in up to seven
  18.      different resolutions:
  19.  
  20.             Base/64   (96x64)
  21.             Base/16   (192x128)
  22.             Base/4    (384x256)
  23.             Base      (768x512)
  24.             4Base     (1536x1024)   (optional)
  25.             16Base    (3072x2048)   (optional)
  26.             64Base    (6144x4096)   (in optional Pro Photo CD ipe file)
  27.  
  28.      A PCD file object represents these different resolution components as
  29.      distinct images; the inherited iflFile member functions sssseeeettttCCCCuuuurrrrrrrreeeennnnttttIIIImmmmgggg(),
  30.      ggggeeeettttCCCCuuuurrrrrrrreeeennnnttttIIIImmmmgggg(), and ggggeeeettttNNNNuuuummmmIIIImmmmggggssss() can be used to select and query the
  31.      current resolution and number of available resolutions.
  32.  
  33.      The 16Base image or both the 16Base and 4Base images may be omitted from
  34.      a Kodak Photo CD Image Pac file; the ggggeeeettttNNNNuuuummmmIIIImmmmggggssss() member function will
  35.      always return 4, 5, 6, or 7.  Resolutions Base/64 through Base are
  36.      quickly accessible from the file, whereas retrieval of the 4Base and
  37.      16Base data (if they exist) involves decompression and therefore takes
  38.      longer per pixel to read.  Resolution 64Base is decompressed from a
  39.      separate set of files under a directory hierarchy rooted under ../ipe
  40.      relative to the Image Pac file holding the lower resolutions.
  41.  
  42.      The orienation of a PCD file is determined by the orientation of the
  43.      image contents on the original film.  It will usually be
  44.      iflUpperLeftOrigin for a landscape (wide) image, and iflLeftLowerOrigin
  45.      or iflRightUpperOrigin for a portrait (tall) image.  In any case, the
  46.      scan lines run along the larger dimension of the image, and the X
  47.      dimension is always 1.5 times the Y dimension (X always varies fastest by
  48.      definition in IFL).
  49.  
  50.      The color model of a PCD file is presented as iflRGB even though
  51.      interanlly it is stored as iflYCC, and its data type is iflUChar.  In the
  52.      Image Pac file, the chrominance (CC) data is usually stored at half the
  53.      resolution of the luminance (Y) data in both the horizontal and vertical
  54.      direction; however, IFL expands the chrominance data to match the
  55.      resolution of the luminance if necessary, so that all three components
  56.      appear to be at the same resolution.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiiffffllllPPPPCCCCDDDD((((3333))))         IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll          iiiiffffllllPPPPCCCCDDDD((((3333))))
  71.  
  72.  
  73.  
  74.      The initial resolution may be selected by appending :<_n> to the filename
  75.      passed to iiiiffffllllFFFFiiiilllleeee::::::::ooooppppeeeennnn(), where <_n> is the index of the desired
  76.      resolution (0 through 6). The default is the Base resolution (index 3).
  77.  
  78.      IFL's access to a Kodak Photo CD Image Pac file is read-only; it does not
  79.      support creation or modification of Kodak Photo CD files.
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      iflFile, iflPCDO
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.